Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions That Modify Movie Properties / Working With Alternate Tracks

SetTrackAlternate

The SetTrackAlternate function allows your application to add tracks to or remove tracks from alternate groups.

pascal void SetTrackAlternate (Track theTrack, Track alternateT);

theTrack

Specifies the track and group for this operation. Your application obtains this track identifier from such Movie Toolbox functions as NewMovieTrack and GetMovieTrack (described on page 2-136 and page 2-188, respectively). The SetTrackAlternate function changes this track's group affiliation based on the value of the alternateT parameter.

alternateT

Controls whether the function adds the track to a group or removes it from a group. If the alternateT parameter contains a valid track identifier, the Movie Toolbox adds this track to the group that contains the track specified by the parameter theTrack. Note that if the track identified by the parameter alternateTrack already belongs to a group, the Movie Toolbox combines the two groups into a single group.

Set this parameter to nil to remove the track specified by the theTrack parameter from its group.

ERROR CODES

invalidTrack

-2009

This track is corrupted or invalid

SEE ALSO

You can determine all the tracks in a group by calling the GetTrackAlternate function, which is described in the next section.